home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 3 / Your Choice Software Collection 3.iso / dos / aview409 / av.doc next >
Text File  |  1994-09-01  |  8KB  |  192 lines
  1. AV.DOC
  2. 09/01/94
  3.  
  4. The AV.EXE program shows a directory of one or more archive files (ZIP, ZOO,
  5. etc), including some self-extracting files.  Features of this program:
  6.  
  7.   * The directory information is presented in full-screen mode and you can
  8.     use PgUp and PgDn to scroll amount the screens
  9.   * Allows you to sort the display of the members in a number of ways
  10.   * Allows you to reset the file date of the archive to match the date of
  11.     the most recent member of the archive
  12.  
  13.  
  14. A typical display might look (in part) like the following:
  15.  
  16. FILL311.ZIP       Date      Time OrigSize Method    NowSize  %reduce  1 of 1
  17. ------------  --------  -------- -------- -------- --------  -------
  18. FILL.DOC      93/11/07  18:04:06     8671 Imploded     3569    59
  19. FILL.EXE      93/11/07  18:43:42    85242 Imploded    56133    35
  20. BRUCE311.DOC  93/11/07  17:39:52    15449 Imploded     6002    62
  21. CONFIGWS.DOC  93/09/25  22:08:42     4601 Imploded     1762    62
  22. CONFIGWS.EXE  93/09/25  14:31:28    67444 Imploded    47271    30
  23. FILE_ID.DIZ   93/01/31  12:46:18      264 Shrunk        210    21
  24.  
  25. (blank lines skipped)
  26.  
  27. ============  ========  ======== ======== ======== ========  =======
  28.  *6           93/11/07  18:43:42   181671            114947    37%
  29. FILL311.ZIP   93/11/07  18:43:42   115551  PgUp, PgDn, Esc, Quit, Sort?
  30.  
  31.  
  32. When viewing a screen's worth of information, the choice is typically:
  33.  
  34.         PgDn    view the next screen's worth
  35.         PgUp    view the previous screen's worth
  36.         Esc     go to the next archive file (if any, else quit)
  37.         Quit    return to DOS
  38.         Date    update the archive date
  39.         Sort    change the sort order for this and subsequent files;
  40.                 you're prompted for "BY?" and you should enter either
  41.                 "-x" or "x" (see below) or press Esc to get out of this:
  42.                 the archive is reread after you ask to re-sort it
  43.  
  44.         RMouse  right mouse button is treated as PgDn
  45.         LMouse  left mouse button is treated as PgUp
  46.         BMouse  both mouse buttons together is treated as Esc
  47.  
  48. If the number of members in the archive exceeds 820, the program will continue
  49. to process the members but it will turn off the display of all information
  50. except for file names and will skip all sorting options.  If the number of
  51. members exceeds 1200, the program will skip all subsequent members although the
  52. information on last date and total bytes should still be accurate.
  53.  
  54.  
  55.  
  56. The AV.INI file:
  57.  
  58. AV will read a AV.INI file if one is found.  (You can specify a different file
  59. name if desired.) The file is an ASCII text file that can be created maintained
  60. by hand.  The file can consist or one or more command line parameters (only
  61. those that begin with a "/"), one statement per line.
  62.  
  63. The file can also contain comments which are blank lines or any line beginning
  64. with:
  65.         ;    (semi-colon)
  66.         :    (colon)
  67.         '    (quote)
  68.  
  69. AV looks for the initialization file in your default subdirectory first.  It
  70. then searches for it in the subdirectory where the executable was and then goes
  71. through your DOS path.
  72.  
  73. Passing in "/-I" or "/INULL" skips loading the AV.INI file.
  74.  
  75.  
  76. CONFIGWS.EXE:
  77.  
  78. In addition to using the AV.INI file, you can permanently change some defaults
  79. within AV.EXE by using the CONFIGWS.EXE program.  CONFIGWS.EXE is not included
  80. in the AV distribution package but previous versions can typically be used with
  81. AV if desired.  (The same CONFIGWS.EXE program can be used to path a number of
  82. Wayne Software programs.) If CONFIGWS can't patch the executable, it will notify
  83. you of this before altering anything.
  84.  
  85. CONFIGWS.EXE allows you to set the following defaults:
  86.  
  87.         Pause output:   /P or /-P
  88.         List order:     /ON, /O-N, /OS, /O-S, /OD, /O-D, /OE, /O-E, /OC, /O-C
  89.  
  90. When setting options, the program will process defaults in the following order:
  91.   (1) CONFIGWS.EXE-settable settings
  92.   (2) AV.INI settings
  93.   (3) command-line settings
  94.  
  95. The *last* settings encountered win.
  96.  
  97.  
  98.  
  99. Syntax:
  100.  
  101.     AV filespec [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /Iinitfile | /I ]
  102.       [ /Q ] [ /? ] [ > filename ]
  103.  
  104. where:
  105.  
  106. "filespec" is the file specification to process.  Can include drive, path, and
  107. wildcards if desired.
  108.  
  109. "/P" says to view the directory in page mode.  This is the default but you can
  110. change this setting using the program CONFIGWS.EXE.  The default is
  111. automatically /-P (which can't be overridden) if redirection ("AV ... >
  112. filename") is used.
  113.  
  114. "/-P" says to view the directory not in page mode.  This prevents you from being
  115. offered the fix-date option as well.  This mode is automatic if redirection ("AV
  116. ... > filename") is used.
  117.  
  118. "/Ox" and "/O-x" allow you to specify the display order for the files.  "x" can
  119. be one of the following:
  120.  
  121.         N = file name
  122.         E = file extension
  123.         D = file date and time
  124.         S = file size of the original (non-compressed) file
  125.         C = current (compressed) size of the file
  126.         O = original order (no sorting)
  127.  
  128. If you precede the "x" with a dash ("-"), the sort will be done in reverse
  129. order.  Defaults to /OO but this can be altered using CONFIGWS.EXE.
  130.  
  131. "/DATE" resets the file date to that of the most recent member.  Automatically
  132. invokes /-P.  The command "AV *.* /DATE /Q" is a quick way to reset the file
  133. date stamps for all archives in your current subdirectory.
  134.  
  135. "/Iinitfile" says to read an initialization file with the file name "initfile".
  136. The file specification *must* contain a period.  If no drive or path information
  137. is specified, the program will search for initfile beginning in your default
  138. subdirectory and then going throughout your DOS path.  The use of an
  139. initialization file is optional.  Initially defaults to "/IAV.INI".
  140.  
  141. "/-I" (or "/INULL") says to skip loading the AV.INI initialization file.
  142.  
  143. "/Q" skips the display of the member names.  Automatically invokes /DATE and /-P
  144. and is typically used in cases where you want to reset all file dates (e.g. "AV
  145. *.* /Q").
  146.  
  147. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  148.  
  149. ">filename" redirects the output to a text file.  This automatically invokes
  150. the /-P option.  This is useful for getting a complete listing of the
  151. contents of your compressed files.  For example:
  152.  
  153.         AV *.* > TEMP.TXT
  154.  
  155.  
  156. Return codes:
  157.  
  158. AV returns the following ERRORLEVEL codes:
  159.         0 = no problems
  160.       254 = no valid archives were found
  161.       255 = syntax problems, file not found, or /? requested
  162.  
  163.  
  164. Author:
  165.  
  166. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  167. and redistribution provided relevant documentation is kept with the program, no
  168. changes are made to the program or documentation, and it is not bundled with
  169. commercial programs or charged for separately.  People who need to bundle it in
  170. for-sale packages must pay a $50 registration fee to "Wayne Software" at the
  171. following address.
  172.  
  173. Additional information about this and other Wayne Software programs can be found
  174. in the file BRUCEymm.DOC which should be included in the original ZIP file.
  175. ("ymm" is replaced by the last digit of the year and the two digit month of the
  176. release.  BRUCE312.DOC came out in December 1993.  This same naming convention
  177. is used in naming the ZIP file that this program was included in.) Comments and
  178. suggestions can also be sent to:
  179.  
  180.  
  181.                 Bruce Guthrie
  182.                 Wayne Software
  183.                 113 Sheffield St.
  184.                 Silver Spring, MD 20910
  185.  
  186.                 fax: (301) 588-8986
  187.  
  188. See BRUCEymm.DOC file for additional contact information.
  189.  
  190. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  191.  
  192.